Find Children
AutomatR.Web.FindChildren
The "Find Children" activity in AutomatR's Web Activities category is designed to retrieve a collection of UI elements based on specified filter criteria within a given scope. This activity is particularly useful for obtaining a list of child elements that match certain conditions, facilitating more complex automation workflows.
Properties
| Name | Description |
|---|---|
| Input | |
| Filter | String specifying the conditions of all UI objects in the collection. It serves as a filter criteria for finding child elements. |
| Web Selector | Select the web element (e.g., a button) to indicate the element on the web using the selector window. |
| Misc | |
| Display Name | Provides a customizable name for the activity displayed in the workflow. String variables containing the desired display name. |
| Optional | |
| Timeout | Enter the time in seconds (e.g., 5 seconds) for the activity to be executed before throwing an exception. Default timeout is used if not specified. |
| Delay | Enter the wait time in seconds (e.g., 5 seconds) before starting the activity. Useful for handling synchronization issues. |
| Output | |
| Out Element | Returns a list of UI children found according to the applied filter criteria. Variables of type List<Selector> to store the result. |
How to use:
- Drag and drop the "Find Children" activity onto the workflow.
- Configure the "Filter" property to specify the conditions for the UI objects you want to retrieve.
- Use the "Web Selector" property to indicate the web element (e.g., button) to help define the scope for finding child elements.
- Optionally, configure the "Timeout" and "Delay" properties based on your requirements.
- Execute the workflow to retrieve the list of UI children based on the specified filter criteria.
Example: Consider an example where the "Find Children" activity is used to retrieve a list of buttons within a specific web element:
Find Children:
Filter: "Button"
Web Selector: <your_selector_here>
Timeout: 10
Delay: 2
Out Element: listOfButtons
In this example, the activity searches for all UI children within the specified web element that match the filter criteria "Button." The list of buttons is stored in the variable "listOfButtons" for further use in the workflow.